Skip to content

chore(sdk): refresh byte-pinned mirror to @appos.space/plugin-types@3.0.2 (fn-182 completion-review r3 P1) - #6

Merged
acebytes merged 1 commit into
mainfrom
url-mirror-3.0.2
Aug 14, 2026
Merged

chore(sdk): refresh byte-pinned mirror to @appos.space/plugin-types@3.0.2 (fn-182 completion-review r3 P1)#6
acebytes merged 1 commit into
mainfrom
url-mirror-3.0.2

Conversation

@acebytes

Copy link
Copy Markdown
Contributor

What

Refreshes the byte-pinned SDK type mirror to @appos.space/plugin-types@3.0.2, resolving fn-182 completion-review r3 P1 (the dev-plugin mirror at plugins/appos-dev/skills/appos-plugin-dev/reference/plugin-api/globals.d.ts still taught the disproven %3A%253A href double-encode claim).

Delta (docblock/README-only)

3.0.2 carries ONLY a documentation correction in the globals declaration:

  • URL.href docblock: the disproven "Pinned divergence: … DOUBLE-encoded on an href round-trip" claim is replaced with the verbatim-round-trip contract (%3A stays %3A — matching WHATWG).
  • The var URL divergence catalog gains the explicit "NOT a divergence" note: the widely-reported double-encode reproduces only via Foundation's URLComponents.queryItems construction path, which this API never uses (host parses with URL(string:), serializes with absoluteString).

No type-surface change (43 namespaces / 135 canonical scopes unchanged; 3065 → 3072 lines, docblock only).

Mirror order (fn-182.4 increment-2 precedent)

  1. npm install --save-dev --save-exact @appos.space/plugin-types@3.0.2 first
  2. scripts/check-sdk-freshness.sh --update
  3. Mirror + INDEX.md + .sdk-integrity + package.json + package-lock.json committed together

Verification

  • Mirror grep: the disproven href double-encode claim is gone from both former sites (href docblock + divergence catalog). The one remaining %253A mention is the 3.0.2 "NOT a divergence" queryItems-only note itself — byte-verbatim from the integrity-pinned published tarball.
  • Teaching content already aligned: patterns.md + compiled/plugin-factory-context.md carry the queryItems-only wording from PR docs(patterns): URL contract accuracy fixes from fn-182.5 codex review #4 — no changes needed.
  • npm run checkexit 0:
    • freshness OK @3.0.2 (10 d.ts files byte-equal to tarball; integrity sha512-tOwRoCkCeXe…t1Vg==)
    • verify-knowledge all green (16 teaching files, 69 fences; fail-closed count parsers happy with 3.0.2)
    • freshness:compiled OK — factory context byte-identical (generator excludes globals.d.ts + strips JSDoc), no regen triggered; 179067 bytes ≤ 179200 ceiling
  • No Desktop-side Sources/TwoPanez/Resources writes.

….0.2

Docblock-only delta in globals.d.ts: replaces the disproven
%3A -> %253A href double-encode claim with the verbatim-round-trip
contract, plus the 'NOT a divergence' note pinning the double-encode
to Foundation's URLComponents.queryItems path (which this API never
uses). Resolves fn-182 completion-review r3 P1.

Mirror order per fn-182.4 increment-2 precedent: npm install --save-exact
first, then check-sdk-freshness.sh --update; mirror + INDEX.md +
.sdk-integrity + package.json + package-lock.json committed together.

Gates: npm run check exit 0 (freshness OK @3.0.2, verify-knowledge all
green, compiled freshness OK — factory context byte-identical, no regen).
@acebytes
acebytes merged commit 88bfb07 into main Aug 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant